An HREFTrack is a specially named text track that contains hypertext references (HREFs). These references are in the form of URLs and can point to any kind of data that a URL can specify, such as a Web page, a QuickTime movie, or a JavaScript.
A URL can be invoked automatically when the movie plays, or it can be invoked interactively when the user clicks the mouse inside a movie. The URL can optionally be targeted to a named frame or browser window, or to the QuickTime movie itself.
HREFTracks are only active when the movie is played by the QuickTime plug-in. The standard movie controller and the QuickTime Player application treat HREFTracks as ordinary text tracks.
Because an HREFTrack is a text track, it will display its samples as on-screen text while the movie plays. This is normally desirable during debugging. To turn the text off, disable the track by calling the SetTrackEnabled function.
When flattening a movie that contains an HREFTrack, be careful not to accidentally delete the disabled text track by calling FlattenMovie with the flattenActiveTracksOnly flag.
You can only have one HREFTrack per movie. If you add more than one HREFTrack to a movie, the QuickTime Plugin will use the first one it finds and ignore any others.
| Previous | Chapter Contents | Chapter Top | Next |